





Staat srop.exe * f#8oo 

MAC / 65 Beschrelbung. 

Der MAC/65 gibt es auf Diskette und auf ROM. Beide Versionen 
sind annähernd 1 den11 sch. D 1 ese Beschreibung gilt für öle 
Diskversion. Auf der Systemdisk sind noch ein Debbuger 
(BUG/65) und einige Be 1 sp 1 eilprogramme . MAC/65 sollte nur 
mit dem sogenannten "COM-DOS" (OS/AO der Firma 03S benutzt 
werden, da MAC/65 auf dieses DOS ausgerichtet ist. MAC/65 
läuft auf allen ATARI'a mit mindestens 48k RAM. Zum Anfang 
noch ein paar benutzte Ausdrücke welche bei der Funktionen¬ 
beschreibung benutzt werden: 

Ino - Zellennummer zwischen 0 und 65535 Inclusive. 

(Ino stammt von llnenumber) 

hxnu» - Hexzahl. Adresse oder Vert, integer ohne Vohr- 
zelchen. (hxnum stammt von hex number) 

dcnum - Dezimalzahl zwischen 0 und 65535. Dezimal¬ 
zahlen werden auf zwei Bytes gerundet. So 
ergibt 3.5 den Vert 4 und 100.1 den Vert 
100, dcnum hat kein Vorzeichen. 

(dcnum stammt von declmal numbers) 

exp - Ein assembler Ausdruck. Z.B LDA, .OPT usw. 

(exp stammt von expresslon) 

strlng - Alphanummerlscher ASCII Ausdruck ln zwei 

Anführungsstrlchen eingebettet. Z.B "Hallo". 

strvar - Vle strlng nur ohne Anfürungsstrlche. 

Kann alles sein we1 z.B. I$10 oder ein Macro. 
(strvar stammt von strlng representa11on ) 

fllespec - Alphanummerlscher ASCII Ausdruck der ein Gerät 
oder zur Eln-Ausgabe bestimmt. Z.B. ID:SCREEN.ASM. 

flle (fllespec stammt von flle specific) 


Haken zeigen an, daQ der nachfolgende Ausdruck nur eingege¬ 
ben werden mu8, wenn er auch benötigt wird. 

Z.B. .VORD exp [exp.). Pünktchen zeigen an das der Aus¬ 

druck sooft wie nötig eingegeben werden soll wie gewünscht 
wird. Klammern zeigen an das einer der Ausdrücke benutzt 
werden kann. Z.B (,Q) (,A). 

Zum Editor generell: MAC/65 unterscheidet zwischen 

TEXT HODE und EDIT MODE. 

IBX1 MODE. 

Im Elnschaltrooment ist der EDIT MODE aktiviert. Geben Sie 
TEXT ein um ln den TEXT MODE zu gelangen. In diesem Mode 
wird kein Syntaxcheck ausgeführt, was hel&t Sie können al¬ 
les eingeben was Sie wollen MAC/65 nimmt es an. Alle (nach¬ 
folgend beschr1 ebenen Ed 1 tot funkt Ionen funktionieren ln 
TEXT MODE. 


In diesem Mode können Sie Ihr' Aasemblerprogram* schreiben. 
MAC/65 iberprüft sofort eine eingegebene Xolle oder Kom¬ 
mando *uf Richtigkeit, und gibt einen Fehler aus sollte et¬ 
was nicht stimmen. Erkennbar Ist dieser Mode an Wort EDIT. 




E DITOR COHHANDOS 

Kommando: ASM ( » £ 11 espec?.) , [ » f 1 lespec2 ], [ I f 11 espec3 ) 

Zweck : Assembllert Quelltext, erstellt Llstlng 

und produziert (wenn gewünscht Sourcecode). 

fllespecl ■ Arbeitsspeicher 
£ilespec2 * Bildschirm 

f 1 lespec3 - Speicher (Achtung: Siehe Note) 

Venn Sie nur ASM eingeben, so gilt die oben genannte Ein¬ 
ste 1lung . 

Beispiel: ASM »D2:SOUCRE,»D:LIST,ID2:OBJECT 

Hier kommt der Quellcode von D2:SOUCRE, das Llstlng wird un¬ 
ter D:LIST abgespeichert und der Objektcode wird ln 
D2:SOURCE geschrieben. 

Beispiel: ASM ID:SOURCE,,)D:OBJECT 

Hier wird der Quellcode von D:SOURCE gelesen, das Llstlng 
wird am Bildschirm gezeigt, und der Objektcode wird unter 
D.-08JECT abgelegt. 

Beispiel: ASM ,IP: 

Quelltext stammt aus dem Spe1 cher, ,Objektcode wird ln den 
Speicher geschrieben und das Llstlng erscheint auf dem 
Drucker . 

Note : Ein Objektcode wird nur produziert, wenn im Assem¬ 
blerprogramm die Anweisung .OPT OBJ enthalten ist. 

/ 

Kommando: BEOAD Ifllespec 

Zweck : Binär f1le laden (OS/A+ Format) 

Kommando: B S AVE Ifllespec < hXnuml, hxnum2 
* 

Zweck : Savet definierten Speicher als Blnärflle ab. 

(OS/A+ Format) 

Beispiel: BS AVE I D : OBJ ECK 5000,5100 

Der Spe1 eherbreich zwischen $5000 und $5100 wird auf Disk 
unter dem Namen "OBJECT" abgelegt. 

Kommando: BYE 

Zweck : Sprung zum ATARI Memo Pad (bei 800) 
oder Seiftest (bei 800XL). 

Kommando: C hxnural< (,) (hxnum) [(,)(,hxnu«)....) 

Zweck : Direkter Speicherzugrlf£ 

Beispiel: C 5000<20,00,DB,,5 

Bel diesem Beispiel geschiet folgendes: 



$5000 bekommt den Vert $20, 

$5001 " $00, 

$5002 " " " $DB, 

$5003 bleibt unverändert und' 

$5004 bekommt den Vert $05 zugeordnet. 

Kommando: D hxnuml (, hxnura2) 

Zweck : Zeigt SpelcherInhalt ln Hexzahlen an. 

Venn hxnum2 nicht angegeben lat, dann werden nur die darauf¬ 
folgenden acht Verte angezeigt. 

Kommando: DEL. lnol l,lno2J 

Zweck : Löschen von Zellennummern 

Note lnol mu8 Im Speicher atehen. 

Kommando: DOS 

Zweck : Zurück zum DOS um z.B. die Directory zu sehen. 

Note : RUN atartet MAC/65 wieder. 

Kommando: ENTER »flleapec I(,M) (,A)J 

Zweck : Läd ASCII oder ATASCII Datei ein. 

Note : Parameter "M" bedeutet Herge=verschmelzen die 

neue Datei wird an die alch Im Speicher befind¬ 
liche angehangen. Alte Zellen werden durch neue 
ersetzt. 

Parameter "A" ermöglicht ein unnummer1ertes 
Programm "e l zuENTERn". ACHTUNG "A" löscht erat 
den" Speicher bevor geladen wird. 

Kommando: EIND /atrlng/ (lnol J [,lno2 ] (,A) 

Zweck : Suchen eines bestimmten Ausdrucks lm Quelltext. 

Beispiel: FIND /LDX/ 

Es wird das Erste "LDX" gesucht. 

Beispiel: FIND /Label/25,80 

Es wird das EllLc. "Label" zwischen den Zellen 25 bis 80 
gesucht. 

Note : Venn die Option "A" gegeben Ist, werden alle 
gefundenen Strings ln dem angegebenen 
Abschnitt angezeigt. 

Kommando: LIST (»fllespec, (flnol J,(lno2 ) ) 

Zweck : Listen von Quelltextze1 len. 

Beispiel: LIST »P: 

Das gesamte Assemblerprogramm wird «uf de» Drucker 
ge 11s te t. 



Beispiel: LIST |D:TEHP / 1030,1800 

Listet nur die Zellen 1030 bjs 1800 auf Disk zwei unter dem 
Namen "TEMP". 

Kommando: L, O J\. D Ifllespec l / A) 

Zweck : Laden eines Asserablerprogrammes . 

Note : Parameter "A" bewirkt das der Speicher nicht ge¬ 
löscht wird. Alte Zellen werden nicht überschrie¬ 
ben. D.H. es können Zellennummern doppelt auf¬ 
trete n. 

Kommando: L.OMEM hxnum 

Zweck : Betlmmung der Startadresse des Quelltextes. 

Note : Quelltext wird gelöscht. 

Kommando: I>JEW 

Zweck : Quelltext und wird gelöscht, EDIT MODE wird 
gesetzt. 

Note : Verläßt TEXT MODE. 

Kommando: NUM ( (dcnuml) (,dcnum2)] 

Zweck : Automatische Ze 1 lennuiumer lerung . 

Beispiel: NUM 1000,20 

Startzelle Ist 2000, es wird ln 20zlger Schritten gezählt. 


Venn nur NUM angegeben wird, dann wird die letzte sich lm 
Speicher befindliche Zellenummer plus zehn angezeigt. Wird 
nur dcnuml angegeben, so wird von der letzten Zellennuramer ♦ 
dcnuml an gezählt, ln dcnuml Schritten. 

Note : BREAK bricht Autonummerierung ab. 

Kommando: E R. I N T (Ifllespec, ) (lnolj, (lno2]J 

Zweck : Siehe LIST Kommando. Unterschied: Es werden keine 
Zeilennummern gellstet. 

Kommando: REN (dcnuml ] (,dcnum2) 

Zweck : Umnuramerlerung von Que11textze11en. 

Die erste Zellenummer Ist dcnumml, incrementlert wird mit 
dcnum2. Verden keine Verte angegeben so wird dcnuml und 
dcnum2 auf 10 angenommen. 

Note : Die Zellenummer dcnuml muß in Speicher stehen! 



Komma ndo: 

REP /old string/nev strlng/ ((lnol) Ilno2)J l(,A) (,Q)] 

i 

Zweck : Ersetzen eines Ausdrucks durch einen Anderen. 

Parameter "A" bedeutet das alle gefundenen "old strlngs" ln 
dem angegebenen Raum ersetzt werden. Parameter "Q" bedeutet 
das vor jeder Substitution gefragt wird. (Y+Taste RETURN be¬ 
deutet ersetzen, nur Taste RETURN heißt nicht ersetzen). 
Verden keine Parameter angegeben, so wird nur der ersteAus- 
druck ersetzt. 

Beispiel: REP /LDY/LDA/200,250,Q 

Dieses Beispiel durchsucht die Zellen 200 bis 2S0 nach dem 

Ausdruck "LDY", und fragt (wenn gefunden), ob ersetzt werden 
soll. 


Note 


Taste BREAX bricht die Funktion ab. 


Kommando: S A.'VE Ifllespec 


Zweck 


Speichert A-ssembl e r pr ogr anua auf das angegebene 
Cerät ab. 


Kommando : S I Z E 

Zweck : Anzeige von drei Werten deren Bedeutung Ist: 

Vertl = Niedrigste benutzbare Speicheradresse 

(kann mit Kommando LOMEM gesetzt werden) 
Vert2 = Höhste vom User benutzte Adresse 
Vert3 = Höh3te benutzbare Adresse 


Note 


Zweck 


Note 


Alle Verte sind Hexadezimal. 


Kommando: TEXT 


Erlaubt es dem Benutzer alles einzugeben was er 
will, es erfolgt kein Syntaxcheck. 

Kommando NEW bricht TEXT MODE ab. Alle Daten 
werden gelöscht. 


Kommando: 7" 


Zweck : Zahlen Umrechnung. 

Beispiel: ? $1200 ergibt =<608 
? 8190 ergibt =$1FFE 

Als letztes Kommando, sei der 

MA.C65 (fllel) I f 11 e 2 J (flle3) (t-A) (-DJ) 

Befehl genannt. Br hat den gleichen Zweck wie das ASM Kom¬ 
mando, »lt dem'Unterschied das dieser Befehl direkt aus de* 
DOS eingeget^en werden muß. 

Option "-A" bedeutet das der Quelltext ln ASCII gehalten 
Ist, Option *-p" heißt das eine Disk to Disk Assembllerung 
gewönscht |at, Mit dieser Option können Quelltexte die lAn- 



ger 3ind als der Hauptspeicher fassen kann bearbeitet werden 
MAC/65 bietet auch eine Menge Operatoren an, als da wären: 

Operatoren: + — * / 

Plus - Minus - Mal - Geteilt, normale Operatoren wie qe- 
wohnt (16 Bit). 

Beispiel: 5FF00M096 ergibt S0F00, es wird kein Oberlauf an¬ 
gezeigt. 

Operatoren: & 1 "* 

AND - OR - EXOR (16 BIT) Bitweise. 

Beispiel: $FF00 & $00FF ergibt $0000 
$03 t $0A ergibt $000B 
$003F Ä $011F ergibt $0120 

Operatoren: = > < <> >= < — 

Gleich - Größer - Kleiner - Ungleich 
Größer Gleich - Kleiner Gleich 

Beispiel: 3<5 ergibt 1 
S<5 ergibt 0 
5<=5 ergibt 1 

Operatoren: . OR. .AND .NOT 

Logische Operationen. 

Beispiel: 3 .OR 1 ergibt 1 

3 .AND 2 ergibt 1 

6 .AND 0 ergibt 0 

.NOT 7 ergibt 0 

Operator : — 

Negatives Vorzeichen. 

Beispiel: -2 Ist gleich mit $FFFE (0-2) 

Operatoren: < > 

Zerlegt 16 Bit Wert ln High und Low Teil. 

Beispiel: PLEEP*$3456 

LDA KFLEEP (entspricht LDA f$S6) 

LDA I>FLEEP (entspricht LDA J$34) 

Operator : . DEF 

Dieser Befehl testet ob der nachfolgende Label bis dahin 
schon definiert wurde. 

Beispiel: .IF .DEF ZILK 

.BYTE "ein paar Bytes" 

.ENDIF 

ZILK - $3000 

Als Vert abergibt DEP die Zahl 0 (nein), denn der Label 
"ZILK" wurde bis dahin noch nicht deklariert. ACHTUNO: Da 



ZILK danach aber bestimmt wird, sieht HAC65 lm zweiten As- 
sembllerung3durchgang das es doch den Label "ZILK" gibt, 
HAC65 meldet dann "OUT OF PHASE". Bel .DEF gilt, entweder 
der Label wird vor dem .DEF deklariert oder garnlcht. 

Note : In diesem Beispiel wird der Befehl 

.BYTE "ein paar Bytes" nicht assembllert. 

(Da .DEF ja den Wert Null ergibt). 

Operator : . REF 

Beispiel: .IF .REF PRINTMSG 

PRINTHSG 
(Code 

der PRINTMSG 
Rout 1 ne) 

.ENDIF 

Für den Öperator REF gilt das Gleiche wie für DEF, mit dem 
unterschied, das REF den Wert eins ergibt wenn der nachfol¬ 
gende Label auch benutzt wurde, z.B durch: 

LDA I<PRINTMSG, 

JHP PRINTMSG, 

JSR PRINTMSG usw. 

Dieser Befehl Ist ein effizienter Weg mehrere Routinen be¬ 
reit zu haben, und nur die benötigten zu Assemblleren. 

Operatoren: C 3 

Beispiel: LDA GEORG£*5*3 ;lst erlaubt, es wird 3*5 

gerechnet und zum Label 
GEORGE addiert. 

LDA (GEORGE*51 *3 ;erst wird die 5 addiert, 

und dann der Wert mit 3 
multipliziert. 

LDA {(GEORGE*5 ] *3),Y;Ist ok . 


Operatoren können beliebig zu einem Assemblerausdruck zusam¬ 
mengestellt werden, HAC65 bestimmt nach den oben vorgestell¬ 
ten Kriterien eine 16 Bit große Zahl (ohne Vorzeichen). 

Zu den Steuerbefehlen. Solche Befehle werden auch Pseudoas¬ 
semblerbefehle genannt, welche nicht mit 6502 Befehlen zu 
verwechseln sind. 

Befehl : * = 

Zweck : Bestimmung wo der folgende Quellcode "hlnas- 
sembllert" werden soll. 

Beispiel: 50 *= $1234 

Setzt Zeiger auf $1234 

Diese Anweisung wird auch dazu verwendet, um mehreren Bytes 
Platz zu ochaffen. 

Beispiel: 70 LOC *»*+5 

Reserviert fünf Bytes für den Label "LOC". 



Befehl : . D B V TE 


Zweck : Weist Speicher eine 16Blt Zahl zu. 
Beispiel: 10 . DB YTE $1234,1,-1 

Es werden folgende Bytes erzeugt: 12 34 00 01 FF FF 
Note : Siehe auch Befehl ".VORD" 

Befehl : . EL S E 

Note : siehe VIF- Befehl zur Erliutrung. 

Befehl : .END 


Zweck 

Note 


Befehl 

Zweck 

Note 

Befehl 

Zweck 


Programmende Anzeige. 

Es wird bei .END nur die Assemblierung beendet 
wenn aus dem Speicher Assembliert wird. 

(Ist nötig um den Befehl .INCLUDE richtig er¬ 
setzen zu können) 

. EN DIF 

Beendet eine definierten Programmblock. 

Siehe ".IF" Befehl zur Erläutrung. 

- ERROR strlng 

Erzeugung eines Pseudoerrors, bei dem 
der nachfolgende strlng ausgegeben wird. 


Beispiel: 100 .ERROR "FEHLENDE PARAMETER" 


Befehl : .IE exp 

[ -ELSE] 
- EN DI E 


Zweck : Entscheidung ob der nachfolgende Quelltext 

assembliert wird, als Kriterium gilt der Wert des 
nachfolgenden Operand. (l=Ja=war bzw. truth). 

Venn eine ".IF" Anweisung gefunden wird,wird getestet ob exp 
null oder eins Ist. Ist exp gleich null so wird der Pro¬ 
grammteil zwischen ".ELSE" und ".ENDIF" assembliert. Gibt es 
keine ".ELSE" Anweisung, so wird nichts zwischen ".IF" und 
" .ENDIF" assembliert. Hat exp den Vert eins, so wird das 
Programmteil zwischen ".IF" und ".ELSE" übersetzt. Wurde 
kein ".ELSE" Befehl verwendet, so wird alles zwischen " IF" 
und ".ENDIF" assembliert. 


Beispiel: 10 .IF 1 ;exp Ist eins 

20 LDA I'? 

30 DSU CHAROUT 
40 .BNDIF 


Da der IF-Test immer positiv ausfällt (exp ist 1) werden die 
Zellen 20 und 30 immer assembliert. Siehe auch " REF" und 
".DEF" Ope*anten. 




Note : Maximale Ve rschate1ungs11efe sind H offene 
".IF" Anweisungen. Fehlende ".ENDIF" 

Befehle werden nlch angezeigt. 

Befehl : . INCLUDE »fllespec 

Zweck : Blnblnden eines Assemblerprogrammes 
ln ein Ande res. 

Beispiel: 10 ; Programm 1 
20 LDA 110 
30 STA $D100 

40 ,INCLUDEID:PR0GRAM2.A£M 
50 JSR SEND 
60 .END 

Es werden die Zellen 10 bis 30 bearbeitet, dann wird von 
Diskette da3 Programm "PROGRAM".ASM" (ran)assembllert da¬ 
nach werden die letzten Zellen abgehandelt. 

Note : Das " 1 nc1udtetes" Programm wird nur solange as- 
sembllert bis ein ".END" Befehl gefunden wird, 
oder es zu Ende Ist. Ein "includetes" Programm 
darf seinerseits kein anderes Programm "lncluden"! 

Befehl : „ L. OCAL 

Zweck : Erklärt neue locale Zone, und schließt Alte ab. 

Locale Variablen gelten nur für einen durch ".LOCAL" defi¬ 
nierten BereIch.•Somlt können die gleichen Labelnamen mehr — 
^**h verwendet werden. Locale Labels haben als erstes Zei¬ 
chen immer ein 


Beispiel: 10 

*= §4000 

11 

LDX »3 

12 

7 LOOP 

13 

LDA VON,X 

14 

STA NACH,X 

15 

DEX 

16 

BPL 2L00P 

17 

• 

18 

.LOCAL ; neue Local Region 

19 

i 

20 

?LOOP=6 

21 

• 

/ 

22 

LDY I7L00P ; entspricht LDY »6 

23 

(usw.) 

Note : Locale Label3 werden ln der 

Symbol table nicht angezeigt. 

Befehl : . OPT Option 

(oder) 

• OPT N O Option 

Zweck : Steuerung von Assemblerfunktlonen 

bei 

def Assemblierung. 


Erlaubte Optionen sind: 


LIST ERR EJECT OBJ MLIST CLIST NUM VAIT 



LIST : 
NO LIST : 
ERR : 
NO ERR ; 
EJECT : 

NO EJECT: 


OBJ : 

NO OBJ : 
NUM : 


NO NUM : 

MLIST : 
NO HL I ST: 
CLIST 
NO CLIST: 
VAIT 


NO WAIT : 


Assembler 1lstIng wird angezeigt. 

Assemblerllstlng wird nicht angezeigt. 

Auftretende Fehler werden angezeigt. 

Auftretende Fehler werden nicht angezeigt 

-‘ dc S ‘ Uc ‘ lnc s '>ten*ahl ang« 2 el,t 
und falls gewünscht ein Titel. g 

Es wird über Jede Seite keine Seitenzahl und 

Ü 1 gezel ^ t * (N0 EJEC T hat keinen ElnfluB 
auf den ".PAGE" Befehl) 

Es wird ein Objectcode ln den Speicher bzw. zum 
angegebenen Gerät gesendet. 

Es wird kein Objectcode generiert. Gut für Ver¬ 
suchsassemblierungen. 

Das ausgegebene AssemblerlIst Ing wird von 100 an 
ln Einerschritten durchnummeriert. (Nur die Aus¬ 
gabe nicht das Programm). 

Es werden die verwendeten Zellennummern 
angezeigt. 

Listet alle Hacrozellen. 


Listet nur die assembllerten Hacrozellen 
Listet alle Zellen. 

Listet nur die assembllerten Zellen. 

Wartet bevor Seltennummer und Titel angezeigt 
werden.(Nur sinnvoll wenn ein Drucker mit Ein¬ 
zelblatt verwendet wird). START setzt Assem¬ 
blierung fort. 

Alles wird in einem Stück (durch)assemb 11ert. > 


Verden keine Optionen angegeben, so gilt: 


LIST 
ERR 
EJECT 
NO NUM 
MLIST 
CLIST 
NO VAIT 
NO OBJ 


es wird ein Llstlng ausgegeben 

Errors werden angezeigt 

Seltennummer und Titel werden angezeigt 

verwendete Zellennummern werden angezeigt 

alle Hacrozellen werden gellstet 

alle bedingten Zellen werden gezeigt 

es wird- nicht gewartet 

siehe Notel 


Note : OBJ Ist zweifach zu sehen: 

Wird ln den Speicher assembllert gilt NO OBJ. 
Wird zu einem Gerät assembllert, so gilt OBJ. 

Befehl : . PAG IC (strlng) 


Zweck : Überschrift. 


Der nachfolgende String wird unter die Seitenzahl und dem 
Titel gedruckt, außerdem wird die nächste Seite angefangen. 


Befehl 

Zweck 

Note 

Befehl 

Zweck 


: . SBYTE 

: Produziert Bildschirmkompatible Bytes. 

: Siehe Befehl ".BYTE" zur Erklärung, 
s « SEIT dcnuml, dcnuto2 

: Kontrolle verschiedener Assemblerfunktionen 


dcnuml 


dcnum2 


Funktion: 




0 


(4) 1-4 Setzt die Anzahl der 

Objectbytes die bei den 
Befehlen .BYTE und . SBYTE 
nebeneinander lm Object¬ 
feld des Asserabler11st1ngs 
dargestellt werden. 

1 (0) 0-31 Setzt den linken Rand des 

Assembler 1 IstIngs (Anzahl 
der Space die vor jeder 
leIle stehen). 

Note : Die Verte ln den Klammern stellen 
die Standartelnstellung dar. 

Befehl : . TITLE strlng 

Zweck : Bestimmung der Überschrift die neben der Seiten¬ 
angabe stehen soll. 

Befehl : . WORD 

Zweck : Weist Speicher eine 16Blt Zahl zu. 

Im Unterschied zum ".DBYTE" Befehl wird hier die Zahl ln 
6502 LSB/MSB Form genneriert. 

Beispiel: .WORD $1234,1,-1 

E3 werden folgende Bytes 1 genneriert: 34 12 01 00 FF FF 


Zu den Macros. Ein Macro ist eine Serie von Assemblerbe¬ 
fehlszeilen welche einen Namen zugeordnet bekommen. .Venn 
MAC65 dann/diesen Namen lra Befehlsfeld findet, werden dort 
diese Zellen assembllert. Macros können auch Parameter über¬ 
geben werden, welche dann bei assemblleren eingesetzt 
werden. 

Befehl : . ENDM 

Zweck : Ende eines definierten Macros 
Befehl : . MACRO macronaroe 

Zweck : Start eines Macros. 

Alle Zeilen zwischen .MACRO und .ENDM werden abgespeichert 
lm Macrospelcher. Ein Macro kann Seinerseits nlch auch ein 
Hacro enthalten. 

Beispiel: 10 .HACRO PUSHXY 

20 TXA 

30 PHA 

40 TYA 

50 PHA 

60 .ENDM 

Sollte Jetzt der Befehl "PUSHXY" eingegeben werden, so wer¬ 
den die Zellen 20 bis 50 assembllert. 

Alle benutzter) Labels in einem Macro, sind locale Labels, 




und gelten nur für das ^acro. Mle Labelwertzuordnungen 
durch den Befehl werden wie der Befehl behandelt. 


Macroparameter: Es besteht die Möglichkeit Macro’s Para¬ 
meter zu übergeben/ welche dann bei der Assemblierung einge¬ 
setzt werden. (Maximal 63 Parameter pro Macro sind erlaubt). 
Es wird zwischen Zahlenparameter und Zeichenparameter unter¬ 
schieden. Zahlenparameter werden durch "\" gekennzeichnet, 
und Zeichenparameter durch 

Beispiel : 10 .MACRO 1 

20 LDA I>\1 ;Es wird das Hlgh-Byte von Para¬ 
meter 1 eingesetzt. 

30 CMP (\2,X) ;Pararaeter 2 wird eingesetzt. 

40 SYMBOL.“SYMBOL+1 

50 LDX l\(SYMBOL) ;Der Parameter mit der Num¬ 
mer des Labels "SYMBOL" 
wird e1ngese tzt. 

60 .BYTE \$1,\2,0 ; Es werden die Stringpara¬ 
meter 1 und 2 eingesetzt, 
und danach der Wert null. 

Parameter \0 hat eine besondere Bedeutung, er gibt an wie¬ 
viel Parameter übergeben werden. (Z.B. wird ein Macro assera- 
bllert welches 3 Parameter braucht, es werden aber nur 2 
übergeben, mit Parameter \0 kann dieser Fehler leicht er¬ 
kannt und abgefangen werden. Mit Hilfe diese Parameter 'kön¬ 
nen auch Makros effizienter programmiert werden. 

Beispiel: 10 .HACRO PRINT 

20 ; DIESES MACRO GIBT EINEN STRING 

30 ; AUF DEM BILDSCHIRM AUS. 

40 .IF \0 - 1 ; WURDE EIN STRING ÜBERGEBEN? 

50 JMP LBL1 ,' JA,SPRINGE UND 

60 STRING .BYTE \1,EOL; SPEICHERE STRING AB 

70 ; 

80 LBL1 

90 LDX I>STRING ;ADRESSE DES STRINGS IN X&Y 
100 LDY I<STRING 

110 JSR STRINGOUT ;UND AUSGEBEN 

120 .ELSE ;ANSONSTEN WURDE KEIN STRING 

130 LDA »EOL ; ÜBERGEBEN, ALSO NUR EIN EOL 

140 JSR CHAROUT ;AUSGEBEN 

150 ; 

160 .ENDIF 
170 .ENDM 

Um da3 Macro "PRINT" zu nutzen ein Beispiel: 

1000 PRINT "HALLO, MEIN MACRO FUNKTIONIERT" 

1010 PRINT 


Zu guter letzt noch die Fehlermeldungen, und dann Ist alles 
gescha f f t: 

1 - MEMORY PULL : Speicher Ist voll 



INVALID DELETE 


/ 

9 

4 

5 

6 

7 

8 

9 

10 

11 - 

12 - 

, 13 - 

14 - 

15 - 

16 - 


Die erste Ze l lennummer des "DEL" 
Be ehls muö lm Speicher stehen 
b>.-f. die zweite Zellennummer muö 
grcöer sein als die Erste. 


BRAUCH ERROR : gl n verwendeter Branch-Be f ehl. 

kann die angegebene Distanz 
nicht überspringen. 

NOT Z-PAGE 

/ IHMADIATE MODE : Ein Zeropage Befehl wurde auf eine 

Adresse außerhalb des Zeropage an¬ 
gewandt. 


UNDEFINED ; Ein Und 1f1nlertes Label 

wurde benutzt. 


~ EXPRESSION TO 

komplex 

- DUPLICATE LABEL 

- BUFFER OVERFLOW 

- CONDITIONAL 
NESTING 

- VALUE > 255 


: Es wurden zu viele Ausdrücke be¬ 
nutzt (z.B., = .MACRO, Labels). 
Defenleren Sie ihre Labels tempo¬ 
rär 5 1 

: Ein Label wurde mehrfach mit "=" 
Verte zugeordenet. 

: Syntaxbuffer Ist voll. Kürzen Sie 
Ihre Programmze1lcnlänge. 


. Es fehlen zu .IF Anweisungen 
.ENDIF Befehle. 

: Eine Rechnung hat einen Wert >255 
ergeben, und ein Vert <=255 wird 
gebraucht. 


CONDITIONAL STACK: Zu viele .IF Anweisungen wurden 

verschatelt programmiert. 


•_ NESTED MACRO 

DEFINITION : Ein Hacro enthält ein weiteren 

MACRO Befehl. 


OUT OF PHASE 


Ein Label welches im ersten Phase 
nicht existierte, ist jetzt lm 
zweiten Phase aufgetaucht. 

.(Siehe auch " . R E F " Befehl. 


*= EXPRESSION 
UNDEFINED 


Der Programmzäh 1er wurde rückwärts 
gesetzt, so wird z.B. ein eben 
assembllerter Objectcode 
übe rschr1 eben. 


SYNTAX OVERFLOV : Die Zeile ist zu lang als das 

MAC65 einen Syntaxcheck durch¬ 
führen kann. 


DUPLICATS MACRO 

NAME 


Es "•''den zwei 
gleichen Nansen 


Macros mit dem 
definiert. Mur 



der Erste zählt. 


17 - 

18 - 

19 - 

20 - 

21 - 

22 - 

23 - 

24 - 

25 - 

30 - 

31 - 

32 - 

128 - 

Ach du 
ist er 

Befehl 

Z veck 

dcnuml 

dcnum2 


LINE I > 65535 

MI SS I NC .ENDM 

NO ORIGIN 


: MAC65 akzeptiert nur Zellen- 
nummern <- 65535. 

. Es vurde ein BOL gefunden, bevor 
der ".ENDM" Befehl gefunden vurde. 
Ein Macro darf sich nicht 
über mehrere Files erstrecken. 

: E3 vurde kein Befehl ver- 

vendet. Dieser Fehler tritt nur 
auf venn ein Objectcode erstellt 
vl rd . 


NUM/REN OVERFLOW : Bel einer der beiden Befehle wurde 

eine Zellennummer >65535 erzeugt. 

N5STED .INCLUDE : Ein Includetes File kann seiner¬ 
seits kein anderes File lncluden. 

LIST OVERFLOW ; Der llst output Buffer hat mehr als 

255 Zeichen empfangen. Nehmen Sie' 
kleinere Werte beim ".TAB" Befehl. 

NOT SAVED FILE : Ein zu bearbeitendes File vurde 

nicht gefunden. 

LOAD FILE TO BIG : Da3 File paöt nicht 

ln den Speicher. 

NOT BINARY SAVED : Ein File velche 3 nicht binär Ist 

vurde versucht mit ".BLOAD" 
zu laden. 

UNDEFINED MACRO : Ein Macro vas nicht existiert 

vurde versucht aufzurufen. 

MACRO NESTING : Die maximale Verschachtelung 

eines Macros von 14 Ebenen vurde 
überschritten. 


BAD PARAMETER : Einem Macro vurden Parameter über¬ 
geben, obvohl es keine braucht, 
oder es vurden mehr al 3 63 Para¬ 
meter übergeben. 

255 (Normale 
System 
Fehler¬ 
meldungen) : Zur Erkläng 3lehe ATARI-Handbuch. 


Schande, ich vergaß einen Befehl zu beschreiben, hier 


- TÄEJ dcnuml, dcnum2, dcnum3 
* setzen von Tabulatoren zur Lesbarkeit, 
setzt die Startspalte des, Instruktionsfeld . 
setzt die Startspalte des Operantenfeld. 


dcnum3 setzt die S.tartspalte des Beme r k ungs fe ld . 
Beispiel :100 .TAB 16,32,50 


1000 .TAB 8,12,20 ;setzt Standard Verte. 

Zur näheren Erklärung eine Typische Assenxbler ze l le : 

1FB7 8503 1390 STA CASINIT + 1 ; REMARK 

I InstrucktIonen! iParameter! lBemerk-1 
Feld , Feld kungs 

Feld 




